.TH E1432_PRE_ARM_MEASURE 3 E1432
.SH NAME
e1432_pre_arm_measure \- Manually move E1432s from PRE_ARM to IDLE state
.IX e1432_pre_arm_measure(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_pre_arm_measure(E1432ID hw, SHORTSIZ16 ID,
                                 SHORTSIZ16 wait_after)
.cE
.SH DESCRIPTION
\fIe1432_pre_arm_measure\fR moves all modules in the group from the
\fBPRE_ARM\fR state to the \fBIDLE\fR state.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

This function performs a "manual pre_arm", and does not need to be
called unless the group's pre-arm mode is E1432_MANUAL_ARM.  This
function is called after \fIe1432_init_measure\fR.  This function
waits for all modules to be in the \fBPRE_ARM\fR state, before
proceeding further, and it will return an error if this state is not
reached after a limited time.

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.  If the measurement involves more than one module, it is
mandatory that a \fIgroup ID\fR be used, rather than a \fIchannel
ID\fR.

\fIwait_after\fR determines whether this function will wait for the
module to actually move beyond the \fBPRE_ARM\fR state.  If zero, the
function does not wait; if non-zero, the function waits.
.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_init_measure, e1432_set_pre_arm_mode, e1432_arm_measure
.ad
